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Preface 


This guide provides reference information for using VAX C on ULTRIX ™ sys¬ 
tems. It also contains information on how to develop and debug VAX C programs 
on the ULTRIX operating system running on VAX hardware. VAX C is not 
intended for use on RISC hardware. 


Intended Audience 

This guide is intended for experienced and novice programmers who need refer¬ 
ence information on VAX C for ULTRIX systems. 


Document Structure 

This guide has ten chapters and four appendixes as follows: 

Chapter 1 describes portability considerations for migrating C source programs 
between different compilers and the VMS and ULTRIX operating systems. 

Chapter 2 explains how to create and compile and link VAX C programs. It also 
describes the forms of compiler output that you can select. 

Chapter 3 discusses the debugging facilities provided by the dbx debugger and 
how to use the dbx commands. 

Chapter 4 explains the structure of VAX C programs, including an introduction 
to the language, methods of controlling program flow, and the fundamental 
structures such as function definitions, ke 3 rwords, blocks, and comments. 

Chapter 5 describes the VAX C statements that provide flow control, conditional 
executions, looping, and interruption. 

Chapter 6 discusses the expressions and operators available in VAX C, including 
unary, binary, conditional, comma, and assignment. Chapter 6 also explains the 
rules for data-type conversions. 

Chapter 7 explains the data types and declarations that VAX C supports. 
Chapter 8 describes the storage classes and allocation. 

Chapter 9 explains the purposes and appropriate uses of the various VAX C 
preprocessor directives. 

Chapter 10 explains the purposes and appropriate uses of the various VAX C 
predefined macros and builtin functions. 


ULTRIX is a trademark of Digital Equipment Corporation. 
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Appendix A describes how to use the Ik linker as a separate tool for linking, 
instead of using the vcc command, which both compiles and links programs. 

Appendix B lists all the diagnostic messages produced by the vcc command 
program and the VAX C compiler. 

Appendix C describes the mechanisms available to assist in transporting C 
programs between the VMS and ULTREX operating systems. 

Appendix D provides a summary of the vcc command and the language elements 
of VAX C. 


Associated Documents 

You may find the following documents useful when programming in VAX C. 

The last two documents are included if you want to transport VAX C programs 

between the ULTRIX and VMS operating systems. 

• The C Programming Language^ — Provides a more intensive tutorial than 
that found in the beginning of Chapter 4 of this guide. 

VAX C contains additional features and enhancements to the C language as it 
is defined in The C Programming Language. Therefore, use this guide as the 
reference for a full description of VAX C. 

• ULTRIX Documentation Set — Provides information about the ULTRIX 
operating system and its utilities. 

• Guide to VAX C — Provides tutorial infonnation that describes using VAX C 
on the VMS operating system. 

• VMS Master Index — Provides information on the VAX machine architecture 
in the VMS operating system environment. (This index identifies manuals 
that cover inividual topics about using the VMS operating system.) 


Conventions 


Convention 


Meaning 


I RETURN I The symbol I return | represents a single stroke of 

the RETURN key on a terminal. 

[CTRuxi The symbol Ictrl/xL where letter X represents 

a terminal control character, is generated by 
holding down the CTRL key while pressing the 
key of the specified terminal character. 

% cprog I RETURN I In interactive examples, the user’s response to 

a prompt is printed in red; system prompts are 
printed in black. 


^ Brian W. Kemighan and Dennis M. Ritchie, The C Programming Language (Englewood Cliffs, New Jersey: Prentice 
Hall, 1988). 
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Convention 

Meaning 

float x; 

A vertical ellipsis indicates that not all of the text 
of a program or program output is shown. Only 
relevant material is shown in the example. 

X = 5; 


option, .. . 

A horizontal ellipsis indicates that additional 
parameters, options, or values can be entered. A 
comma that precedes the ellipsis indicates that 
successive items must be separated by commas. 

[output-source, ... ] 

Square brackets, in function synopses and a few 
other contexts, indicate that a syntactic element 
is optional. Square brackets are not optional, 
however, when used to delimit the dimensions of 
a multidimensional array in VAX C source code. 

sc-specifier ::= 

auto 

static 

[extern] 

register 

[alb] 

In syntax definitions, items appearing separate 
hnes are mutually exclusive alternatives. 

Braces surroimding two or more items separated 
by a vertical bar ( 1 ) indicate a choice; you must 
choose one of the two syntactic elements. 

A 

A delta symbol is used in some contexts to indi¬ 
cate a single ASCII space character. 

auto storage class 
^rintf function 

Boldface t3rpe identifies language keywords and 
the names of independently compiled external 
functions. 
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